---
title: IPolicyHeaderAssociation
summary: API reference for IPolicyHeaderAssociation.
status: draft
owner: SAIF Claims BOF team
last_reviewed: 2026-08-21
library: SAIF.Business.Policy
reference_type: embedded
---

# IPolicyHeaderAssociation

Extends `IPolicyAssociation` with the display-oriented fields needed by policy-header views. Stage 1 analysis confirmed that `SAIF.Business.View.Policy` consumes this contract through `clsPolicyAssociation`.

## Purpose
- Add display fields to the base association contract so header UIs can show related-policy details.
- Keep header consumers from needing a separate lookup once association rows are returned.
- Preserve the base association identity and direction inherited from `IPolicyAssociation`.

## Context
- Namespace: `SAIF.Business.Policy`
- Assembly/package: `SAIF.Business.Policy`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `PolicyNumber` | `ReadOnly Property PolicyNumber As Decimal` | Identifies the associated policy. |
| `IsParent` | `ReadOnly Property IsParent As Boolean` | Indicates whether the associated policy is the parent side of the relationship. |
| `AssociationType` | `ReadOnly Property AssociationType As IPolicyAssociationType` | Describes the relationship family governing this association row. |
| `Equals` | `Function Equals(ByVal inAssociation As IPolicyAssociation) As Boolean` | Lets implementations compare header association rows using the base association contract. |
| `PolicyName` | `ReadOnly Property PolicyName As String` | Supplies the display name for the associated policy. |
| `AgentNumber` | `ReadOnly Property AgentNumber As Decimal` | Supplies the agent number shown with the associated policy. |
| `AgencySeqNum` | `ReadOnly Property AgencySeqNum As Decimal` | Supplies the agency sequence number shown with the associated policy. |
| `PolicyStatusDescription` | `ReadOnly Property PolicyStatusDescription As String` | Supplies the display-ready status text for the associated policy. |
| `PeriodEffectiveDate` | `ReadOnly Property PeriodEffectiveDate As Date` | Supplies the effective date of the associated policy period. |
| `PeriodExpirationDate` | `ReadOnly Property PeriodExpirationDate As Date` | Supplies the expiration date of the associated policy period. |

## Constraints and usage notes
- Implementations must satisfy the full `IPolicyAssociation` contract because `IPolicyHeaderAssociation` inherits it.
- Known consumers in the solution live in `SAIF.Business.View.Policy`.

## Sources
- `SAIF.Business.Policy\IPolicyHeaderDataProvider.vb`